home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / vwansi32.zip / VWANSI.DOC < prev    next >
Text File  |  1992-09-10  |  12KB  |  278 lines
  1.                           Online ANSI Viewer v3.2
  2.                         (c) 1991, 1992 E.L. Morrow
  3.                        written in  Turbo Pascal  6.0
  4.                            utilizing RMDOOR 3.0
  5.  
  6.                                    -by-
  7.  
  8.                          Nocturnal Aviation Software
  9.                                 E.L. Morrow
  10.  
  11.                           911 N. Pacific Ave #15
  12.                           Crescent City, CA 95531
  13.                           Voice: (707) 465-6765
  14.  
  15.  
  16.   DISCLAIMER:   
  17.         I relinquish any and all responsibility for anything that may
  18.   occur due to the use of this program, correctly or incorrectly.  I am
  19.   in no way libel for any damage that is attributed to the use of this
  20.   program by any and all persons.
  21.  
  22.  
  23.   SHAREWARE:
  24.         Online ANSI Viewer is ShareWare.  It's not crippled or
  25.   anything, but it does let your users know that it isn't registered by
  26.   showing #UNREGISTERED# at the top of the header on the selection menus.
  27.   
  28.         Registration is only $15 for this new version.  Future upgrades
  29.   will be priced accordingly depending on how much is changed and added.
  30.   Anyone who registers now will never have to pay for another registration
  31.   of this program.  Your registration number will be good for all versions.
  32.  
  33.         Distribution of this program will be solely the province of the
  34.   large number of BBS's across the country.  I can't afford to send disks
  35.   out to people who register.  I know this sounds kind of crude, but if
  36.   you enclose your BBS number when you register along with a password to
  37.   get on your system, I'll upload the latest version (if it's different) 
  38.   and send you a private message in an appropriate conference that will
  39.   list your registration information (just a reg number and name actually).
  40.  
  41.         Print and fill out the form in this archive called VWANSI.REG
  42.   and mail it to:
  43.                         Elm L. Morrow
  44.                         911 N. Pacific Ave Apt 15
  45.                         Crescent City, CA 95531
  46.  
  47.         Make checks or money orders payable to: Elm L. Morrow
  48.  
  49.   SETTING UP:
  50.  
  51.         This version of the ANSI Viewer is multi-node.  In order to
  52.   use this door on a multi-node BBS you need to have a configuration file
  53.   for each node.  All of the files in the archive and the configurations
  54.   should be put into their own directory.
  55.  
  56.         Setting up the Viewer is fairly easy.  The first thing you need
  57.   to do is set up the config files.  They don't *have* to be called
  58.   VWANSI1.CFG, VWANSI2.CFG, etc... , but it maintains clarity and ease
  59.   of use if they are.  They take this form:
  60.  
  61.                 PCB                  {BBS Type}
  62.                 C:\BBS               {Dir of the node's door files}
  63.                 Works of Art BBS     {Name of BBS--registration name}
  64.                 Elm Morrow           {Sysop's full name}
  65.                 0                    {locked baud rate}
  66.                 NOT REGISTERED       {registration number}
  67.  
  68.         BBS Type can be of several types:
  69.  
  70.                 PCB             PCBoard
  71.                 GAP             GAP (DOOR.SYS)
  72.                 SF              Spitfire, 
  73.                 RBBS            RBBS  
  74.                 WC              WildCat!
  75.                 TRIBBS          TriBBS,
  76.                 WWIV            WWIV
  77.  
  78.         Location of definition files is the directory where your door
  79.   files are when the BBS shells out to the door.  In other words, if
  80.   you're running PCBoard, line 2 needs to point to the location of
  81.   PCBOARD.SYS, PCBOARD.DAT, and USERS for that node.
  82.  
  83.         BBS Name or registration name goes on line 3 of the config file.
  84.   I guess if you can't work that one out, I can't help you much! <grin>!
  85.  
  86.         SysOp Name should be the main SysOp's name as it appears in the
  87.   BBS configuration.  It's not really critical.
  88.  
  89.         Locked baud rate is for high speed modems.  If you lock your port
  90.   at 19200 or 38400, put it here in that form (i.e. 19200 or 38400).  This
  91.   door does not require a FOSSIL driver to run at high speeds.  If you 
  92.   have trouble, please contact me!  
  93.  
  94.         Registration number is the number you get from me that will replace
  95.   the word #UNREGISTERED# in the header of all the menus to whatever your
  96.   BBS name is (or whatever you register under---best to choose the BBS name).
  97.  
  98.         Okay!  Now for the stuff that isn't quite so easy....  In addition
  99.   to the configuration file, you need some definition files for the list
  100.   of categories and a list of files for each category.  I know, I know, who
  101.   needs manual setup?  Well, register the darn door and I'll put together
  102.   an automated/assisted setup program!
  103.  
  104.         Here are the files and their formats:
  105.  
  106.                                 CATEGORY.DAT
  107.                                 ------------
  108.         This file contains the list of categories to display on the initial
  109.   category menu.  It's very simple.  It's just a text file that contains
  110.   *SINGLE LINE ENTRIES* that define each element on the menu.  The format
  111.   goes a little something like this:
  112.  
  113.         <category file>,<category description>,<security level>
  114.  
  115.         The first part, <category file>, is the name (and path if it's in
  116.   a separate directory) of the file that contains the list of files in
  117.   this category.  See below.
  118.  
  119.         <category description> is what the user will see when they are
  120.   making their selections from the category menu.  It can be up to 50
  121.   characters in length.
  122.  
  123.         <security level> is the minimum security level the user must have
  124.   in order to be able to view this category.  Just set it to 0 if you don't
  125.   really care.  This is for those SysOps out there that like to segment
  126.   everything they do into different levels of access.
  127.  
  128.            *MAKE SURE YOU SEPARATE EACH FIELD WITH COMMAS!!!*
  129.  
  130.                                Category files
  131.                                --------------
  132.         Category files can have any name and/or extension that you want        
  133.   to give them.  I prefer to use the extension .CAT so I know what the
  134.   file is for.  It is also a normal text file that contains a list of
  135.   single line entries.  These entries will tell the computer what files
  136.   to display and where they are.  The form is similar to the CATEGORY.DAT
  137.   file:
  138.  
  139.            <d:\path\name.ext>,<file description>,<security level>
  140.  
  141.         The first element *must* be the full path and name of the file
  142.   that the user will view when they choose each selection.  If the file
  143.   resides in the same directory as VWANSI, then you only need to provide the
  144.   name and the extension.
  145.  
  146.         <file description> is what the user will see when they are making
  147.   their choices from the ANSI Files menu (or whatever the heck I called it).
  148.   It can be up to 50 characters in length.
  149.  
  150.         <security level> is the minimum security the user must have in 
  151.   order to view the individual file.  A little redundant, but it's very
  152.   easy to put a ,0 at the end of each line.  But, it's impossible to not
  153.   show the selection without this field if you want only some people to
  154.   be able to see it.  This will help avoid creating multiple categories
  155.   for different levels.
  156.  
  157.         That's it!  (as if that weren't enough! <grin>)  It may seem like
  158.   a lot to do, but if you don't have to put a bunch of categories and lists
  159.   together all at once, it's easy to maintain and all of this can be done
  160.   remotely by co-SysOps and other lesser BBS personalities <grin> (don't
  161.   get upset!  *I* used to be a co-SysOp that got to do the grunt work 
  162.   while *their* name went up in lights!)
  163.  
  164.  
  165.  
  166.   RUNNING THE DOOR:
  167.  
  168.         The batch file for this door is simple.  Do something like this:
  169.  
  170.                 cd c:\bbs\doors\vwansi
  171.                 vwansi vwansi1.cfg
  172.                 cd c:\bbs
  173.                 board
  174.  
  175.         There are many BBS schemes for setting up doors, so if this batch
  176.   file doesn't work for you, just read your doc's and find out how to run
  177.   doors.
  178.  
  179.   SPECIAL SYSOP KEYS:
  180.  
  181.      Key(s)              Function
  182.      ------              ---------
  183.      Scroll              If the Scroll Lock key is ON, you will here music
  184.       Lock               locally.  If it's off, you will not.
  185.  
  186.      HOME                Toggles between the user status  window and a
  187.                          help  display that  lists the  RMDoor special
  188.                          keys.
  189.  
  190.      F6                  Takes 5 minutes away from the caller.
  191.  
  192.      F7                  Gives 5 minutes to the caller.
  193.  
  194.      F9                  Quit the  door and  return the caller  to the
  195.                          BBS.
  196.  
  197.      F10                 Enter chat mode.   Pressing the ESC key exits
  198.                          the chat mode.
  199.  
  200.      Alt+D               Drop to DOS.
  201.  
  202.  
  203.  
  204.   USING THE DOOR:
  205.  
  206.         This is the easiest part.  All the user has to do is enter the
  207.   door and make menu selections!  *You've* done all the work!  Here are 
  208.   the few keys they need to know (they're informed while they're in the
  209.   door by a footer listing currently acceptable inputs.)
  210.  
  211.         <2>  -  Go down one selection
  212.         <8>  -  Go up one selection
  213.       <ENTER>-  Choose current selection
  214.        <ESC> -  Exit to last menu or the BBS
  215.  
  216.        That's it!
  217.  
  218.         It came to mind a little too late for this release, but the menus
  219.   support multiple pages.  If there are more selection beyond the end of
  220.   the ones currently viewed (11 at a time), pressing <2> one more time will
  221.   display the next set of selections.  Likewise, pressing <8> at the top of
  222.   the menu box will bring the previous page up.  I'll make a note of that
  223.   and put it on the display for the next upgrade  (definitely will be one).
  224.  
  225.  
  226.  
  227.   SUGGESTIONS, ETC...:
  228.  
  229.         Please leave your suggestions for improvements and any other 
  230.   comments on the following board:
  231.  
  232.         The White Hat
  233.         SysOp: T.J. Steele
  234.         (707) 465-5456
  235.         
  236.         Conference:  Nocturnal Support
  237.  
  238.         
  239.  
  240.         Of course, there's always snail mail.  As a general rule, I don't
  241.   like answering letters, but if you send a check or m.o. for $15 with a
  242.   letter, I'll more than likely get in touch with you one way or the other.
  243.  
  244.         If I've missed something or you can't make sense out of all or part
  245.   of this .DOC file, get in touch and let me know.  It's really not that
  246.   hard to get it set up, but I don't always feel like writing and so the
  247.   descriptions of how to do things get erratic and confusing.  <Sigh>
  248.  
  249.  
  250.  
  251.   HISTORY:
  252.         Version 1.1 
  253.                 was released simply to remove the ShareWare notice that
  254.   my door unit was putting just before entry to the door.  I'm registered
  255.   now, so it's gone.
  256.  
  257.  
  258.         Version 2.0
  259.                 This new multinode version now supports ANSI music!
  260.  
  261.                 Added a local music on/off toggle (scroll lock) and
  262.         cleaned up the music routines a little.
  263.  
  264.         Version 3.0
  265.                 Completely changed the read/write routines to provide
  266.         for faster writes and smoother music.
  267.  
  268.         Version 3.1
  269.                 Recompiled using rmDoor v3.0 which has promised to fix
  270.                 the problem with high speed nodes.
  271.  
  272.         Version 3.2
  273.                 Fixed some new bugs that crept into the ANSI music 
  274.                 routines and added little indicators on the menus to
  275.                 show if more selections were available on the next or
  276.                 previous page(s).
  277.  
  278.